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1. Introduction 



This document describes the features of software release 3.3 of the Network 

TM 

File System (NFS ) option. Silicon Graphics NFS 3.3 is based on NFSSRC 
4.0 and NFSSRC 4.0.3 bug fixes. DES authentification is not implemented. 

Note: Packaged with these release notes is a separate sheet that contains 
the Software License Agreement. This software is provided to you 
solely under the terms and conditions of the Software License 
Agreement. Please take a few moments to review the Agreement. 
Note in particular paragraphs 1 and 2 under the heading * Terms 
and Conditions of Software License." This software may be used 
only by you on one workstation, computer, or server at one time, 
and may be copied only as necessary for backup or archival 
purposes. 

This document contains the following chapters: 

1. Introduction 

2. Additions 

3. Changes 

4. Bug Fixes 

5. Documentation Errors 

(in Administrator' s Guide to Diskless Workstations) 
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1.1 Release Identification Information 

Following is the release identification infonnation for NFS: 
Software Option Product NFS 

Version 3.3 

Product Code S4-NFS-33 

System Software Requirements 4D1-3.3 



1.2 NFS Option Subsystems and Disk Usage 

This section lists the subsystems (and their sizes) on your NFS option tape. 

Those marlced **default' ' are the default subsystems. If you are installing 
this option for the first time, the default subsystems are installed when you 
choose the "default" or ** automatic'* menu items during the installation 
procedure. 

If you are updating from an older version of software, and you select 
^'default" or **automatic'\ the system installs only the default subsystems 
that already are installed. 



Subsystem 


IRIS-4D Series, IRIS'^ 
POWER Series (512 byte 
blocks) 


Personal IRIS 
(512 byte blocks) 


nfs.sw.nfs 
(default) 




3356 






3356 


nfs.sw.dskless 
(default) 




205 






205 


nfs.sw.yp 
(default) 




4686 






4686 


nfs.man.nfs 




323 






323 


nfs.man.relnotes 
(default) 




20 






20 
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1RIS-4D Series 



1.3 Software Installation 

As of system software release 4D1-3.2, optional software product tapes no 
longer contain the software installation tools. Therefore, these release notes 
do not document the installation procedure. The installation software, as 
well as the installation instructions, can be found with the standard products 
you received from Silicon Graphics, Inc. 

The following table shows you where to look for the installation software 
and documentation. 



Software 



Document 



Personal IRIS 



Personal IRIS 



All other IRIS-4D 
Series workstations 
and servers 



Execution-only 
Environment (1) 



Development 
Environment 



Execution-only 
Environment (1) 



3,3 Standard System 
Release and 
Installation Notes 

4D1'3.3 
Development 
Release and 
Installation Notes or 
IRIS'4D System 
Administrator' s 
Guide 

4D1'33 
Development 
Release and 
Installation Notes or 
IRIS-4D System 
Administrator' s 
Guide 
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1.4 On-Line Release Notes 

When you install the on-line documentation for a product, you can view the 
release notes on your screen as you would an on-line manual page. 

The command: 

rolnotes 

displays a list of products that have on-line release notes. The relnotes 
command accepts the following arguments: 

-h describes how to use relnotes 

<product> displays the table of contents for a product's on-line release 
notes 

<product> <chapter> 

displays a specific chapter of a product's on-line release notes 

-t <product> <chapter> 

prints a specific chapter of a product's on-line release notes 

To page through the chapter, press <space> and to quit, press <del> or 
<ctrl-c>. See relnotes{\) for more information. 



1.5 Product Support 

Silicon Graphics, Inc., provides a comprehensive product support 
maintenance program for IRIS-4D Series products. For further information, 
please contact your service organization. 
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2. Additions 



This chapter lists the new features provided with this release of NFS. 

• The automount daemon automatically mounts filesystems on an as- 
needed basis. File hierarchies can be mounted automatically when they 
are used, and unmounted silently following a predetermined idle period. 
The automount utility can be used for a variety of purposes, including 
automatically mounting a user's home directory from any workstation 
connected by NFS. See automount{\M). 

• The Networic Lock Manager allows the locking of records and files 
between NFS clients. The Network Lock Manager consists of two 
daemons, lockd and statd, which run on both the client and the server. 
See tocM(lM), statd{\M) and statmon(4). 

• Thcypchpass(\) utility is a program for updating Yellow Pages user 
information, ypchpass allows users to set their full names, office and 
home phone numbers, home directories, and login shells. See also 
fingeril). 
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3. Changes 



This chapter lists the changes to existing NFS features since the last release 
(3.2). 

TM 

The IRIX version of mountd(\M), which supports export options not 
offered by mountd from other vendors, has been given its own RPC(4) 
program number. This number assignment is contained in the letclrpc 
database. Users of previous YP releases must upgrade their YP master to 
support the new version of the letclrpc database in order to run the IRIX 
mountd. Your YP master should have this line in letclrpc. 

sgi mountd 391004 mount showmount 

Other changes to existing NFS features in the current release include: 

• NFS read/write performance improvements. 

• The mount options, -b list, -n, and -private have been added. See 
mount{\M) 2S\(^fstab{4). 

• The umount option, -b list has been added. See umount(lM). 

• The export option -wsync has been added. See exports(4). 

• The rpcinfo{lM) options, -h program-number [version-number] and -d 
program-number [version-number] have been added. 

• The ability to log various ypserv(\M) activites has been added. See 
ypserv(lM). 

• ypxfer{lM) now logs errors to syslogd{ 1 M). 

• ypbind{\M) now logs errors to syslogd{\M) in addition to the console. 

• There is a new command, ypmake{\M), which executes 
lusrletclyplMakefile and logs its results. See ypmake{\M). 
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The ability to interrupt NFS system calls on hard-mounted filesystems 
has been enhanced and extended. Interrupt response is now faster and 
non-fatal interrupts are no longer ignored. 
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4. Bug Fixes 



This chapter hsts the bug fixes in NFS since the last release (3.2). 

TM TM 

• A bug in SunOS 4. 1 mountd that prevents Sun clients from NFS 
mounting IRIX file systems has been fixed from the (SGI) server side. 
The IRIX version of mountd, which supports additional export options, 
has been given its own RFC program number. 

• A bug that caused confusion between NFS-mounted filesystems has 
been fixed. When asked for information on the current working 
directory, programs such aspwrf(l) and ls(l), sometimes reported 
information for other filesystems. The hash function that caused the 
confusion has been corrected. 

• A bug that could cause nfs_writes to fail if they occurred at certain 
offset/size values and spanned extents in the filesystem has been fixed. 
When the writes failed this message appeared on the console: 

xdr_opaque : decode FAILED 
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5. Documentation Errors 



This section contains corrections to important procedures found in sections 
2,3,3 Creating the Share Tree and 2,3.5 Installing the Client Tree of the 
Administrator's Guide to Diskless Workstations. Read this material before 
you read these chapters in the Administrator' s Guide to Diskless 
Workstations and before you install a diskless IRIS-4D Series workstation. 



5.1 Errata: 2.3.3 Creating the Share Tree 

To create the share tree, use this section instead of section 2.3.3 Creating the 
Share Tree. 

To create the share tree, follow these steps: 

1. Become the superuser. 



2. Move to the directory lusrletclboot. 

# cd /usr/etc/boot 

3. Install the share tree using a clinst command of the form: 

./clinst -c class share 

where class is the name of the class. 

Note: Remember, the name of the share directory is the name of the 
class! 

Version 1.0 Documentation Errors 5-1 



4. When the system prompts you, confirm your request: 

y 

5. The clinst menu appears on your screen. 

clinst is the installation tool that handles the creation and 
removal of share and client trees from the server workstation. 
The clinst command works a lot like the inst command, so if 
you're familiar with inst you should have no trouble with clinst. 
There are two ways to install with clinst, Automatic and Manual. 



5.1.1 Automatic Installation 

If you are installing the software directly from a tape, you can select the first 
item on the menu, '^Install software automatically". This automatically 
installs all the options you have selected from the tapes. 

After each tape is installed, you are prompted for the next tape. Insert each 
tape as you are prompted, then select yes from the menu. When you have 
finished installing all the options from your installation tapes, select no. Do 
not restart the system. 

Verify that the nfs.sw.diskless option has been installed. If not, select the 
nfs.sw.diskless option, and install it. When the installation is complete, 
select the item labeled **quit'' to leave the menu. 



5.1.2 Manual Installation 

If you want to install selectively, or if you want to install the software from 
another location, select the second item on the menu, '*Use manual 
installation features*'. When you select this item, another menu appears. 

There are several items on the manual installation menu. If you are unsure 
about any of them, you can use the **help" selection. 
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Select the item labeled ''from" to tell clinst where to get the software you 
want to install. For example, suppose you want to get software from a 
workstation called gilligan, in a directory called /little/buddy. You would 
select '*from" from the menu, then type the following line: 

guest@gilligan : /little/buddy 

Select the item labeled ''select" to choose particular subsystems to install. 
(If you want to install everything, you don't need this step.) 

Return to the menu. Insert your NFS tape. Select "Use manual installation 
features". When the manual installation menu appears, select" aU". 

Select the item labeled "quit" to leave the menu when the installation is 
complete. 

For more information about using clinst, see the clinst(\M) man page in 
your IRIX System Administrator's Reference Manual, or type: 

% man clinst 



5.2 Errata: 2.3.5 Installing the Client Tree 

Note that the procedure described in section 2.3.5 Installing the Client Tree 
does not involve software installation from tape. All software installed in 
the client tree is already present on the server disk. The software is moved 
to a separate area, tp be used by the diskless machine. 

Use the following procedure in place of step 9 of 2.J.5 Installing the Client 
Tree. This prompt appears on your screen: 

» 
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Set the netaddr, bootfile, and diskless variables using the setenv command 
by typing: 

setenv diskless 1 

setenv netaddr address 

setenv bootfile hootp {) servername: /usr/eZc /hoot /clientname/unix 

where address is the internet address of the client workstation, servername 
is the name of the server, and clientname is the name of the client. 

Disregard step 14 in Section 23.5 Installing the Client Tree. 
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